home *** CD-ROM | disk | FTP | other *** search
/ Windows Expert / Windows Expert.iso / utility / ext_pc.zip / EXTRACT.DOC next >
Text File  |  1991-06-17  |  9KB  |  206 lines

  1.  
  2.                     ******* ExtractorPC 1.00 *******
  3.  
  4.    ExtractorPC is a free utility for expanding the files in archives created by
  5.    Compact Pro(tm).  Note:  ExtractorPC is copyrighted 1991 by Bill Goodman.
  6.    The self-extracting code used to distribute this package was produced by LHA
  7.    which is copyrighted 1988-91 by Haruyasu Yoshizaki.
  8.  
  9.  
  10. Requirements
  11.  
  12.    ExtractorPC works with IBM PCs and compatible machines (there are no known
  13.    incompatibilities).  It requires MS-DOS 2.10 or higher.
  14.  
  15.  
  16. About Compact Pro Archives
  17.  
  18.    A Compact Pro (CP) archive may contain the data for one or more Macintosh
  19.    files and folders in compressed format (a folder is the Macintosh equivalent
  20.    of a directory).  It also contains information about the hierarchical
  21.    structure of the folders within the archive.  This information can be used
  22.    to reconstruct an equivalent "tree" of directories from the archive.  Note
  23.    that the names of files and folders within an archive are not necessarily
  24.    unique, i.e., there can be two files named "FOO" within the same folder.
  25.  
  26.    Typically, an archive is stored as a single file;  however, CP archives may
  27.    be divided into "segments".  A typical use for segmented archives is to
  28.    divide a large archive into pieces that are small enough to fit on floppy
  29.    disks.
  30.  
  31.  
  32. About Macintosh Files
  33.  
  34.    Standard Macintosh files have two "forks" - a data fork and a resource
  35.    fork.  Each of these forks contains a separate block of data which roughly
  36.    corresponds to a file on a PC.  You can think of a Macintosh file as being
  37.    two PC-style files which are linked together with a common name.
  38.  
  39.    In general, the data which Macintosh applications store in resource forks
  40.    is not very useful to non-Macintosh applications.  For this reason,
  41.    ExtractorPC only extracts the data forks of Macintosh files by default.
  42.    An option is provided to extract the resource forks for situations where
  43.    the data in the resource fork is required.
  44.  
  45.    When a CP archive is originally created on a Macintosh, it has both a
  46.    resource fork and a data fork.  When it is transferred to a PC, there are
  47.    two common ways of converting the file to PC format.  Some programs will
  48.    convert the file to "MacBinary" format;  this preserves the data in both the
  49.    resource and data forks.  Other programs will discard the resource fork and
  50.    simply copy the data fork to a PC-style file.  Since the resource fork does
  51.    not contain any data needed to extract the contents of the archive, either
  52.    of these formats is acceptable to ExtractorPC.
  53.  
  54.  
  55. Installing ExtractorPC
  56.  
  57.    No special installation of ExtractorPC is required.  You may place a copy
  58.    in your current working directory or any other directory which is
  59.    referenced by MS-DOS's search path.
  60.  
  61.  
  62. Using ExtractorPC
  63.  
  64.    ExtractorPC is a non-interactive, batch-style program.  It is started
  65.    from the DOS command line by entering "EXTRACT" followed by the name of the
  66.    CP archive to be processed (for segmented CP archives, the names of all
  67.    segment files must be specified in order).  ExtractorPC will extract the
  68.    data forks of all the files in the archive and store them hierarchically in
  69.    the current working directory.  If no errors are detected, ExtractorPC
  70.    returns an exit code of 0 (this value may be tested in batch files).  If any
  71.    error is detected, ExtractorPC terminates and returns an exit code of 1.
  72.  
  73.    ExtractorPC's standard operation may be modified by specifying various
  74.    "options" on the command line.  These options are described in the
  75.    following section.
  76.  
  77.  
  78. Command Line Summary
  79.  
  80.    A> EXTRACT ArcName1 <ArcName2> <ArcName3> <-b> <-dDIRPATH> <-eFNAME> <-f>
  81.                                                   <-l> <-o> <-r> <-s> <-u> <-v>
  82.    Items enclosed in "<>" are optional.
  83.  
  84.    ArcName1
  85.       This is the name of the first segment of the archive to be processed.
  86.  
  87.    ArcName2, ArcName3, ...
  88.       These are the names of the segment files for a segmented archive.
  89.       ArcName2 must be the second segment of the archive and ArcName3 must be
  90.       the third segment, etc.
  91.  
  92.    -b   (binary)
  93.       Normally, ExtractorPC will translate extracted text files by adding a
  94.       linefeed character after every carriage return character.  If the "-b"
  95.       option is specified, no text file translation is performed.
  96.  
  97.    -dDIRPATH   (directory)
  98.       By default, the extracted files are stored hierarchically in the current
  99.       working directory.  The "-d" option may be used to specify a different
  100.       destination directory.  DIRPATH is the path to the desired directory.  It
  101.       may be specified relative to the current working directory ("FOO\SAMPLE")
  102.       or it may be specified as an absolute path ("C:\APPS\EXAMPLE\FUNCTIONS").
  103.       The directory must already exist - ExtractorPC will not create it.
  104.  
  105.    -eFNAME   (extract)
  106.       By default, ExtractorPC extracts all files in an archive.  The "-e"
  107.       option may be used to specify one or more individual files or folders to
  108.       be extracted.  If the file/folder name contains blank characters, it must
  109.       be enclosed in quotation marks, e.g. -e"A Long File Name".  Either upper
  110.       or lower case characters may be used to specify the name.  If the named
  111.       file or folder exists in more than one directory, only the first one
  112.       found will be extracted.
  113.  
  114.    -f   (flat extract)
  115.       The "-f" option suppresses the creation of the folder hierarchy stored in
  116.       the archive.  All files will be stored in the destination directory and
  117.       no folders will be created.
  118.  
  119.    -l   (list catalog)
  120.       If the "-l" option is specified, ExtractorPC displays a list of the files
  121.       in the archive, but no files are extracted.  For segmented archives, it
  122.       is not necessary to list all the segment files if the "-l" option is
  123.       used - only the last segment must be entered on the command line.
  124.  
  125.    -o   (overwrite)
  126.       Normally, ExtractorPC will not overwrite any existing files when it is
  127.       extracting files from an archive.  Selecting the "-o" option instructs
  128.       ExtractorPC to delete any pre-existing files necessary during extraction.
  129.  
  130.    -r   (resource forks)
  131.       Selecting the "-r" option directs ExtractorPC to extract the resource
  132.       forks of files rather than the data forks.
  133.  
  134.    -s   (skip errors)
  135.       If an error is detected during the extraction process, ExtractorPC
  136.       normally halts.  Selecting the "-s" option forces ExtractorPC to skip any
  137.       files which produce errors and continue with the remaining files.
  138.  
  139.    -u   (unique names)
  140.       Since Macintosh filenames can be much longer than PC filenames,
  141.       ExtractorPC often has to shorten the names of extracted files. 
  142.       Sometimes it will not be able to extract the files in an archive because
  143.       several of the names end up being the same after they've been shortened.
  144.       If the "-u" option is selected, ExtractorPC will guarantee that all
  145.       filenames and folder names are unique by creating names of the form
  146.       "NAME0000".  These names may be correlated back to the Macintosh
  147.       filenames by reviewing the text which is output to the screen during
  148.       extraction (note this information may be saved to a file by redirecting
  149.       the output to a file).
  150.  
  151.    -v   (validate archive)
  152.       If the "-v" option is specified, ExtractorPC expands all files and
  153.       verifies that the archive data is valid.  No files are created and no
  154.       data is written to disk.
  155.  
  156.  
  157. Example Command Lines
  158.  
  159.    To extract all the files in a CP archive named "BIGFILES.CPT" and store them
  160.    in the current directory, use the following command line:
  161.  
  162.    A> EXTRACT BIGFILES.CPT
  163.  
  164.    As a second example, suppose you have a segmented archive consisting of the
  165.    files "BIGARC.#1", "BIGARC.#2", and "BIGARC.#3".  You could expand all the
  166.    files from the archive and save them (ignoring any folder hierarchy) in a
  167.    directory named "C:\SAVE\GRAPHICS" with the following command line:
  168.  
  169.    A> EXTRACT BIGARC.#1 BIGARC.#2 BIGARC.#3 -dC:\SAVE\GRAPHICS -f
  170.  
  171.    Note that the segment files must be specified in the correct order, but
  172.    the placement of the options is not important (they may be placed before,
  173.    after, or interspersed with the segment filenames).
  174.  
  175.    To extract the two files named "ReadMe" and "Help Text" from an archive
  176.    named "BBS.CPT" and store them in the current directory, use the following
  177.    command line:
  178.  
  179.    A> EXTRACT BBS.CPT -eREADME -e"help text"
  180.  
  181.  
  182. Limitations
  183.  
  184.    ExtractorPC has the following limitations:
  185.       o Archives with more than 800 files and folders cannot be expanded.
  186.       o Archives with more than 20 segments cannot be expanded.
  187.       o Encrypted files cannot be expanded.
  188.  
  189.  
  190. Problem Reports
  191.  
  192.    ExtractorPC was written by Bill Goodman.  You may report problems or send
  193.    suggestions to the author by US Mail at:
  194.  
  195.       Bill Goodman
  196.       109 Davis Avenue
  197.       Brookline, MA  02146
  198.  
  199.    You may also use the following electronic mail addresses:
  200.  
  201.       Compuserve:  71101,204
  202.       Internet:    71101.204@compuserve.com
  203.       GEnie:       B.GOODMAN5
  204.  
  205.  
  206.